home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / portmap.z / portmap
Encoding:
Text File  |  2001-04-17  |  6.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ppppoooorrrrttttmmmmaaaapppp((((1111MMMM))))                                                        ppppoooorrrrttttmmmmaaaapppp((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      portmap - TCP, UDP port to RPC program number mapper
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////eeeettttcccc////ppppoooorrrrttttmmmmaaaapppp [ ----vvvvmmmmAAAAbbbbCCCC ] [ ----ffff _f_o_r_k_c_n_t ] [ ----aaaa _m_a_s_k,_m_a_t_c_h | ----aaaa _m_a_t_c_h ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _p_o_r_t_m_a_p is a server that converts RPC program numbers into TCP or UDP
  16.      protocol port numbers.  It must be running in order to make RPC calls.
  17.  
  18.      When an RPC server is started, it tells _p_o_r_t_m_a_p what port number it is
  19.      listening to, and what RPC program numbers it is prepared to serve.  When
  20.      a client wishes to make an RPC call to a given program number, it first
  21.      contacts _p_o_r_t_m_a_p on the server machine to determine the port number where
  22.      RPC packets should be sent.
  23.  
  24.      After _p_o_r_t_m_a_p starts, _i_n_e_t_d(1M) can register its standard RPC servers.
  25.  
  26.      Options to customize _p_o_r_t_m_a_p's behavior are read from the file
  27.      /_e_t_c/_c_o_n_f_i_g/_p_o_r_t_m_a_p._o_p_t_i_o_n_s during system initialization.  The options
  28.      are:
  29.  
  30.      ----vvvv   Verbose: prints error messages using _s_y_s_l_o_g(3B) when a service fails
  31.           or when an unprivileged process or remote host tries to set or unset
  32.           a port mapping.
  33.  
  34.      ----ffff _f_o_r_k_c_n_t
  35.           Specify the maximum number of child processes to handle broadcast or
  36.           multicast requests.  The default is 10.
  37.  
  38.      ----aaaa _m_a_s_k,_m_a_t_c_h
  39.      ----aaaa _m_a_t_c_h
  40.           This option permits restriction of most of the portmap services to a
  41.           subset of hosts or networks.  (The portmap null procedure is not
  42.           restricted.)  The _m_a_s_k, and _m_a_t_c_h arguments are IP addresses in
  43.           Internet dot notation (see _i_n_e_t(3N)) that represent masks, hosts or
  44.           networks.  The _m_a_s_k and _m_a_t_c_h arguments must be separated by a comma
  45.           with no intervening whitespace.  If _m_a_s_k and the comma are missing,
  46.           the argument is interpreted as a Class A, B, or C network number and
  47.           the mask is set to the value appropriate for the network's class.
  48.  
  49.           The ----aaaa option can be repeated up to 50 times.  For each mask and
  50.           match specified, the requesting client host's address is logically-
  51.           ANDed with _m_a_s_k; if the result equals _m_a_t_c_h, the client's request is
  52.           processed.  If none of the mask-match comparisons succeed, the
  53.           request is rejected.  Requests from all of the local host's
  54.           addresses are always permitted.
  55.  
  56.           For example, if /_e_t_c/_c_o_n_f_i_g/_p_o_r_t_m_a_p._o_p_t_i_o_n_s contains
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppoooorrrrttttmmmmaaaapppp((((1111MMMM))))                                                        ppppoooorrrrttttmmmmaaaapppp((((1111MMMM))))
  71.  
  72.  
  73.  
  74.                -a 255.255.255.0,128.32.199.0
  75.                -a 192.0.2.0
  76.                -a 255.255.255.255,192.26.51.3
  77.  
  78.           access is restricted to any host on the Class B 128.32.199 subnet or
  79.           the Class C 192.0.2 network or to the host with the 192.26.51.3
  80.           address.  Requests from clients on any other networks are rejected.
  81.  
  82.      ----AAAA   This option is equivalent to a series of ----aaaa options listing all of
  83.           the addresses of interfaces on the machine, with their netmasks.  It
  84.           is convenient for authorizing hosts on directly connected networks
  85.           and point-to-point links without explicitly enumerating the
  86.           networks.  The restrictions defined by ----AAAA do not count against the
  87.           limit of 50 ----aaaa options.
  88.  
  89.      ----bbbb   This option causes the ----aaaa and ----AAAA options to apply only to packets
  90.           that arrive via multicast.
  91.  
  92.      ----mmmm   Enable reception of RPC requests sent to _p_o_r_t_m_a_p's multicast
  93.           address, provided their sources meet the restrictions imposed by ----aaaa
  94.           or ----AAAA.  Multicast requests received from what should be local
  95.           addresses are always ignored.  The ----aaaa and/or ----AAAA options should
  96.           always be used with ----mmmm on machines that can be reached by multicast
  97.           packets from the Internet, such as MBONE feeds.  The ----bbbb option is
  98.           handy with ----mmmm on systems shielded from the Internet by firewalls,
  99.           where all networks that can be reached via unicast or broadcast are
  100.           trusted.
  101.  
  102.      ----CCCC   Turn on compatibility mode.  This will allow local applications to
  103.           register with _pppp_oooo_rrrr_tttt_mmmm_aaaa_pppp using a network address other than the
  104.           loopback address.  Applications that do not use the SGI-provided RPC
  105.           interfaces to register with portmap may require this option to
  106.           function properly.  However, use of this option will also introduce
  107.           a known _ssss_eeee_cccc_uuuu_rrrr_iiii_tttt_yyyy problem.
  108.  
  109. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  110.      inetd(1M), rpcinfo(1M).
  111.  
  112.      _I_R_I_X _N_e_t_w_o_r_k _P_r_o_g_r_a_m_m_i_n_g _G_u_i_d_e
  113.  
  114. BBBBUUUUGGGGSSSS
  115.      If _p_o_r_t_m_a_p crashes, all servers that use it (for example, _n_s_d(1M), and
  116.      _i_n_e_t_d(1M)) must be restarted.
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.